home *** CD-ROM | disk | FTP | other *** search
/ ShareWare OnLine 2 / ShareWare OnLine Volume 2 (CMS Software)(1993).iso / comm2 / zl2b0131.zip / ZIPLAB.DOC < prev    next >
Text File  |  1993-01-31  |  51KB  |  1,135 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.          
  13.          ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▄ ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▄       ▒▒▒▒▒▒▒▒▄  ▒▒▒▒▒▒▒▒▒▄
  14.           ▀▀▀▀▀▒▒█▀  ▒▒█▀  ▒▒█▀▀▀▒▒█  ▒▒█▀       ▒▒█▀▀▀▒▒█   ▒▒█▀▀▀▒▒█
  15.               ▒▒█▀   ▒▒█   ▒▒█   ▒▒█  ▒▒█        ▒▒█   ▒▒█   ▒▒█   ▒▒█
  16.             ▒▒▒█▀    ▒▒█   ▒▒▒▒▒▒▒▒█  ▒▒█        ▒▒▒▒▒▒▒▒█   ▒▒▒▒▒▒▒█▀
  17.            ▒▒█▀▀     ▒▒█   ▒▒█▀▀▀▀▀▀  ▒▒█        ▒▒█▀▀▀▒▒█   ▒▒█▀▀▀▒▒█
  18.           ▒▒█▀       ▒▒█   ▒▒█        ▒▒█   ▒▒▄  ▒▒█   ▒▒█   ▒▒█   ▒▒█
  19.          ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒█ ▒▒▒▒█      ▒▒▒▒▒▒▒▒▒█ ▒▒▒▒█ ▒▒▒▒█ ▒▒▒▒▒▒▒▒▒█
  20.           ▀▀▀▀▀▀▀▀▀  ▀▀▀▀  ▀▀▀▀       ▀▀▀▀▀▀▀▀▀  ▀▀▀▀  ▀▀▀▀  ▀▀▀▀▀▀▀▀▀
  21.                   ▒▒▒▒▒▒▒▒▒▄ ▒▒▒▒▄      ▒▒▒▒▄ ▒▒▒▒▄ ▒▒▒▒▒▒▒▒▄
  22.                    ▒▒█▀▀▀▒▒█  ▒▒█▀       ▒▒█▀  ▒▒█▀ ▒▒█▀▀▀▒▒█
  23.                    ▒▒█   ▒▒█  ▒▒█        ▒▒█   ▒▒█  ▒▒█    ▀▀
  24.                    ▒▒▒▒▒▒▒▒█  ▒▒█        ▒▒█   ▒▒█  ▒▒▒▒▒▒▒▒▄
  25.                    ▒▒█▀▀▀▀▀▀  ▒▒█        ▒▒█   ▒▒█    ▀▀▀▀▒▒█
  26.                    ▒▒█        ▒▒█   ▒▒▄  ▒▒█   ▒▒█  ▒▒▄   ▒▒█
  27.                   ▒▒▒▒█      ▒▒▒▒▒▒▒▒▒█  ▒▒▒▒▒▒▒▒█  ▒▒▒▒▒▒▒▒█
  28.                    ▀▀▀▀       ▀▀▀▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀   ▀▀▀▀▀▀▀▀
  29.                               ▒▒▒▒▒▒▄     ▒▒▒▒▒▒▄
  30.                                ▀▀▀▒▒█     ▒▒█▀▒▒█
  31.                               ▒▒▒▒▒▒█     ▒▒█ ▒▒█
  32.                               ▒▒█▀▀▀▀     ▒▒█ ▒▒█
  33.                               ▒▒▒▒▒▒▄ ▒▒▄ ▒▒▒▒▒▒█
  34.                                ▀▀▀▀▀▀  ▀▀  ▀▀▀▀▀▀
  35.  
  36.                     Copyright (C)1989-93 by Jeffrey S. Morley
  37.                     
  38.                                
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                                                                              
  60.                                                                              
  61.                                                                              
  62.                                                                              
  63.                                                                              
  64.                                                                              
  65.                                                                              
  66.                                                                              
  67.                                                                              
  68.                                                                              
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.  
  76.                                                                              
  77.                                                                              
  78.                                                                              
  79.                                                                              
  80.                                                                              
  81.                                                                              
  82.                                                                              
  83.                                                                              
  84.                                                                              
  85.                                                                              
  86.                                                                              
  87.                                                                              
  88.                                                                              
  89. ZipLab PLUS Version 2.ß.10
  90. (C)Copyright 1989-93 by Jeffrey S. Morley
  91. January 31st, 1993
  92.  
  93. Archive testing and maintenance program for PCBoard/ProDoor Sysops.
  94.  
  95.     
  96.  
  97.                                
  98. ##############################################################################
  99.                             Table of Contents
  100. ##############################################################################
  101.  
  102.       To jump to a section, do a search on the page number in the format:
  103.                 "Pgx" where "x" is the page number to jump to.
  104.  
  105.  
  106. Introduction to ZipLab Plus 2.0 .......................................... 1
  107.                                                                           
  108. Installation of ZipLab / Requirements .................................... 2
  109.                                                                           
  110. Installation of ZipLab / Quick Start ..................................... 3
  111.                                                                           
  112. Installation of ZipLab / A Sample Configuration File ..................... 8
  113.                                                                           
  114. Installation of ZipLab / Configuration Details ........................... 9
  115.                         I.    Conference Specific Configurations ......... 9
  116.                         II.   The ZDCS Duplicate Checking System ......... 9
  117.                         III.  ZLABxxx.TCN Trashcan File(s) ............... 10
  118.                         IV.   ZLABxxx.CMT Comment File(s) ................ 10
  119.                         V.    CRC.ADS .................................... 11
  120.                         VI.   LST.ADS .................................... 12
  121.                         VII.  *.MSG The Message Files .................... 12
  122.                         VIII  PKZIP 2.0 .................................. 13
  123.                                                                           
  124. Installation of ZipLab / Usage Notes and Warnings ........................ 14
  125.                         I.    Command Line Parameters .................... 14
  126.                         II.   PCBoard's TEMP Directory ................... 13
  127.                         III.  ZipLab's WORK Directory .................... 15
  128.                         IV.   Using Giftest with ZipLab .................. 15
  129.                          
  130. Installation of ZipLab / Some Notes on Memory Usage ...................... 17
  131.  
  132. Installation of ZipLab / ProDoor Differences ............................. 18
  133.  
  134. ZipLab Plus Version History .............................................. 20
  135.  
  136. About ZipLab Plus and the Author ......................................... 21
  137.  
  138.  
  139.                                                                            Pg1
  140.  
  141. ##############################################################################
  142.                        INTRODUCTION TO ZIPLAB PLUS  
  143. ##############################################################################
  144.  
  145. What is ZipLab Plus?
  146.  
  147. ZipLab Plus is a shareware program which will test archived files.  In 
  148. addition, ZipLab will allow you to add .ZIP comments, strip out unwanted 
  149. members, and much, much more!  ZipLab was designed for PCBoard/ProDoor 
  150. SysOps, to test files as they are uploaded to their systems.  It is run in 
  151. the PCBTEST.BAT file which comes with PCBoard 14.5.  PCBTEST.BAT is run by 
  152. PCBoard when an upload completes.
  153.  
  154.  
  155. The following is a quick list of ZipLab's features:
  156.  
  157. Testing:  
  158. * Test for CRC errors in the archive file.
  159. * Test for imbedded archive files and if found, CRC check those too.
  160. * Test for imbedded .TD0 (Teledisk) files and if found, test with TDCHECK.
  161. * Virus check archive member files, using your favorite virus checker.
  162. * Virus check inside archive files imbedded inside another archive file.
  163. * Test .GIF files for validity if you accept that file format (Optional)
  164. * Run virus check on files which you optionally pass without ZIP testing.
  165. * Reject programs older than a date (yyyymm) which you specify.
  166. * Uses a "trashcan" file to reject by description keywords you specify.
  167. * Will fully test "self-extracting" archives of the ZIP/ARJ/LZH formats.
  168. * Fully integrated with the ZDCS duplicate checking system from Mike Cocke.
  169.  
  170. Maintenance:
  171. * Remove all archive comments from the file.
  172. * Replace archive comments with your own. (Optional)
  173. * Add the contents of FILE_ID.DIZ to the archive comment.
  174. * Use special ZipLab "@" codes to include test information in the comment.
  175. * Adds the reasons to the comment on files which fail ZipLab Plus testing.
  176. * Delete unwanted BBS ads and/or other unwanted archive members as you define.
  177.   - ZipLab tests for BBS ads by FILENAME or file CRC. 
  178. * Allows you to optionally add a file to the archive.
  179.  
  180. PCBoard/ProDoor BBS specific features:
  181. * Add the resolution of .GIF files to the description (Optional)
  182. * Adds most recent archive member date to the description (Optional)
  183. * Optionally replace the description left by the user if FILE_ID.DIZ is
  184.   found in the archive file.  Formatted to the correct 45 char standard.
  185. * Will make a notation in both the CALLER file and the private DIRx 
  186.   file for the current node of any files which fail upload testing, 
  187.   including the failure reason.
  188. * Allows your users to run the TEST command in PCBoard to test files, 
  189.   but ZipLab will not remove the file unless it fails CRC or virus 
  190.   checking. You will be notified via the node's CALLER file of 
  191.   archives which fail PCBoard's TEST command, and why.
  192. * Takes the phone "offhook" if the user hangs up before/during testing.
  193. * Sends a mail message to the user letting him know why a file was
  194.   rejected, and to both the user and the Sysop when a virus is found.
  195. * Allows full conference specific configurations.
  196.   
  197. General:
  198. * Run the full range of tests on .ZIP, .LHZ and .ARJ archive formats
  199. * Works on a PCBoard/ProDoor BBS in both online and local modes.
  200. * Works with both the old and new versions of PKZip.
  201.   
  202.                                                                            Pg2
  203.  
  204. ##############################################################################
  205.                          ZIPLAB PLUS REQUIREMENTS                 
  206. ##############################################################################
  207.  
  208.  ! YOU MUST BE RUNNING PCBOARD VERSION 14.5(a) OR PRODOOR VERSION 3.44 !
  209.  
  210. You must have the following programs.  Several are included in the ZipLab 
  211. Plus archive, but registration of ZipLab DOES NOT include registration of 
  212. any of these products.  Please SUPPORT SHAREWARE and register these products 
  213. with their respective authors.
  214.  
  215. PKZIP.EXE   - Phil Katz's archive create program (version 1.01 or 2.04)
  216. PKUNZIP.EXE - Phil Katz's archive extract program (version 1.01 or 2.04)
  217. LHA.EXE     - Yoshi's archive program (version 2.13 +)
  218. ARJ.EXE     - Robert Jung's archive program (version 3.00 +)
  219. SCAN.EXE *  - McAffey's virus detection program (any version)
  220. RECOM.EXE   - Mike Loewen's ZIP file comment remover
  221. GIFTEST.EXE - Dave Navarro's .GIF file tester (optional)
  222. TDCHECK.EXE - .TD0 (Teledisk) checker from SyDex (optional)
  223. ZDCSFC.EXE  - The ZDCS duplicate checking system from Mike Cocke.
  224.               Version 2.01 or better is required for seamless operation.
  225.               
  226. * Note!  This can be replaced with the virus checking program of your choice,
  227.   subject to restrictions and requirements outlined in the installation guide.
  228.  
  229. Programs I have written and which are part of the ZipLab Plus package.
  230.  
  231. DELF.COM    - A version of DEL with no "Are you sure?" prompt.
  232. ZLSCR.COM   - A little utility called by ZipLab to help handle the local 
  233.               screen during testing (Based on ProNS.COM by Sam Smith).
  234. ZCRC.EXE    - A small utility to get file CRC values for placement in your
  235.               ADS.CRC file.
  236. ZLAB.EXE    - The ZipLab Plus executable program.
  237. ZSHELL.EXE  - Used by ZipLab to manage memory during "shells"
  238. ZVALID.EXE  - Used to test validity of your ZipLab configuration files.
  239.  
  240.  
  241.                                                                            Pg3
  242.  
  243. ##############################################################################
  244.                                QUICK START 
  245. ##############################################################################
  246.  
  247. * ZipLab does a LOT of things.  It is a complicated program, but a breeze to 
  248.   set up and run... IF you follow the directions and read this entire 
  249.   documentation.  Print this document and follow it step by step.  You can't 
  250.   miss.
  251.   
  252. * Create a directory to hold ZLAB.EXE, the sample ZLAB000.CFG, ZLAB000.TCN, 
  253.   CRC.ADS, LST.ADS, *.MSG, ZLAB000.CMT, ZSHELL.EXE, ZVALID.EXE, ZLSCR.COM, 
  254.   and ZERROR.DAT files. This directory should be in your DOS PATH.  All 
  255.   ZipLab files can be shared by multiple nodes.  Node specific 
  256.   configurations are not required.  Let's assume you use C:\ZIPLAB for now.
  257.  
  258. * UnZIP the enclosed supplemental utilities into directories in your DOS 
  259.   PATH. Make note of where you put them, you will need this information 
  260.   later. Make sure DELF.COM and RECOM.EXE are in your path, and that you 
  261.   know where they are.  This also applies to PKZIP, PKUNZIP, ARJ, LHA, SCAN, 
  262.   and ZDCS (all of which you should already have).  
  263.  
  264. * Using a text editor, edit the ZLAB000.CFG file included in the archive. 
  265.   The "000" in the config name is conference specific.  The default is for 
  266.   conference "0", the "Main Board". More later on how to create conference 
  267.   specific configurations. for now, ZipLab will default to looking for 
  268.   ZLAB000.CFG when run from any conference.
  269.   
  270. * Modify the following information for your system ,in ZLAB000.CFG:
  271.  
  272.  
  273. BBSName=
  274.   The name of your BBS system.  43 characters maximum.
  275.   SAMPLE:  BBSName=The Interconnect Bulletin Board System
  276.  
  277. DateInDesc=
  278.   A "Y" if you wish the "recent date" notation added to the file 
  279.   descriptions.  A "N" if you do not wish this addition.
  280.   SAMPLE:  DateInDesc=Y
  281.  
  282. DateLimit=
  283.   The date (yyyymm) which will be the minimum accepted year.  Archives
  284.   containing files older than this will be rejected.  Example: 199001 would 
  285.   mean any file older than January, 1990 would fail.
  286.   SAMPLE:  DateLimit=199001
  287.  
  288. DizInComment=
  289.   A "Y" if ZipLab should add the contents of FILE_ID.DIZ (if found) to the 
  290.   bottom of the zip comment.  "N" to disable.
  291.   SAMPLE:  DizInComment=Y
  292.  
  293. DizInDesc=
  294.   A "Y" if you wish to replace the description left by the user with the 
  295.   contents of FILE_ID.DIZ (if found in the archive). A "N" if you do not 
  296.   wish to make use of this feature.
  297.   SAMPLE:  DizInDesc=Y   
  298.  
  299.                                                                            Pg4
  300.  
  301. FilesInDesc=
  302.   A "Y" if you wish the "number of archive member files" notation added to 
  303.   the file descriptions.  A "N" if you do not.
  304.   SAMPLE:  FilesInDesc=Y
  305.  
  306. Handshake=
  307.   The type of modem HANDSHAKE you desire.  This can be 0, 1, 2 or 3.  
  308.   0=none, 1=XON/XOFF, 2=CTS, 3=CTS & XON/XOFF (Use 2 or 3 with an error 
  309.   correcting modem...)
  310.   SAMPLE:  Handshake=3
  311.   
  312. OKExtensions=
  313.   A list, all on one line, (separated by ";" - EXE;TXT;GIF) Which will be 
  314.   passed without normal ZIP testing.  SCAN and date checking will still be 
  315.   performed on these files.  Any extensions other than ZIP/ARJ/LZH which do 
  316.   not appear in this list will be rejected by the process. If GIF appears in 
  317.   this list, GIFTEST will be used to test the integrity of the GIF file. If 
  318.   you enter a "*" as one of the extentions, then ALL files will be passed 
  319.   through, with non-archived files being SCAN'd and date checked only. 
  320.   "NONE" in this position will only allow ZIP/ARJ/LZH files to pass.
  321.   SAMPLE:  OKExtensions=GIF;EXE;PCX
  322.  
  323. SendMsgToMain=
  324.   A "Y" if you wish all mail messages sent on failure of an upload to be
  325.   sent to your Main Board conference.  A "N" if you wish the messages sent
  326.   to the conference in which the upload was made.
  327.   SAMPLE:  SendMsgToMain=Y
  328.  
  329. SendSysopMsg=
  330.   A "Y" if you wish the sysop to also receive a mail message in the instance 
  331.   of a virus detection.  A "N" if you do not.
  332.   SAMPLE:  SendSysopMsg=Y
  333.  
  334. SendUserMsg=
  335.   A "Y" if you wish ZipLab to send a mail message to the user when a file 
  336.   fails testing.  A "N" if not.
  337.   SAMPLE:  SendUserMsg=Y
  338.  
  339. ARJPath=
  340.   Full DRIVE:\PATH\FILENAME of ARJ.EXE.
  341.   SAMPLE:  ARJPath=C:\UTILITY\ARJ.EXE
  342.  
  343. AddFilePath=
  344.   The fully qualified filename of a file which you may wish to add to the 
  345.   .ZIP, or "NONE" (please!) if you can refrain from this practice. Once 
  346.   again, ZLAB000.ADD will make sense later.
  347.   SAMPLE:  AddFilePath=NONE
  348.  
  349. CRCPath=
  350.   The full DRIVE/PATH/FILENAME of a text file containing the file CRC for 
  351.   files you wish removed before posting the archive.  This file can be 
  352.   called anything, but CRC.ADS works for me. You can use the included 
  353.   ZCRC.EXE to help maintain this file.  More on the use of ZCRC.EXE later.
  354.   SAMPLE:  CRCPath=C:\ZIPLAB\CRC.ADS
  355.  
  356. CommentPath=
  357.   The full DRIVE\PATH\FILENAME of a zip comment to add.  Again, it is 
  358.   recommended that the name ZLAB000.CMT be used for consistancy.  Specify 
  359.   "NONE" if you don't want to add a comment, or "ZIPLAB" to have ZipLab
  360.   create one for you.
  361.   SAMPLE:  CommentPath=C:\ZIPLAB\ZLAB000.CMT
  362.  
  363.                                                                            Pg5
  364.  
  365. DelfPath=
  366.   Full DRIVE:=PATH\FILENAME of DELF.COM
  367.   SAMPLE:  DelfPath=C:\UTILITY\DELF.EXE
  368.  
  369. FailDir=
  370.   The DRIVE and PATH to the directory where rejects will be placed pending 
  371.   manual sysop inspection.  This can be a common directory on multiple node 
  372.   systems, but SHOULD be an empty (existing) directory dedicated to this 
  373.   purpose. I recommend "d:\FAIL" or "d:\HOLD" as likely names.
  374.   SAMPLE:  FailDir=C:\FAIL
  375.  
  376. GiftestPath=
  377.   Full DRIVE:\PATH\FILENAME of GIFTEST.EXE (or "NONE" if not using)   
  378.   SAMPLE:  GiftestPath=C:\UTILITY\GIFTEST.EXE
  379.  
  380. LHAPath=
  381.   Full DRIVE:\PATH\FILENAME of LHA.EXE.
  382.   SAMPLE:  LHAPath=C:\UTILITY\LHA.EXE
  383.  
  384. LSTPath=
  385.   The full DRIVE/PATH/FILENAME of a text file containing the NAMES (one on 
  386.   each line) of files you wish removed before posting the archive. This file 
  387.   can be called anything you wish, I suggest LST.ADS.  Any files listed in 
  388.   this text file which exist in the uploaded archive will be removed.
  389.   SAMPLE:  LSTPath=C:\ZIPLAB\LST.ADS
  390.  
  391. MsgDir=
  392.   The DRIVE\PATH\ to the directory which will hold the .MSG files. These are 
  393.   the mail messages sent to the user/sysop on failure.
  394.   SAMPLE:  MsgDir=C:\ZIPLAB
  395.  
  396. RecomPath=
  397.   Full DRIVE:\PATH\FILENAME of RECOM.EXE.
  398.   SAMPLE:  RecomPath=C:\UTILITY\RECOM.EXE
  399.  
  400. ScanPath=
  401.   Full DRIVE:\PATH\FILENAME of SCAN.EXE, or another virus checker program.  
  402.   Be sure the program you may chose (other than SCAN) is appropriate for 
  403.   ZipLab.  It MUST have reasonable memory requirements, allow for automatic 
  404.   command line use, and return a DOS ERRORLEVEL on virus detection.  I do 
  405.   not warrent that any virus checker other than SCAN or F-PROT will work 
  406.   correctly.
  407.   SAMPLE:  ScanPath=C:\UTILITY\SCAN.EXE
  408.  
  409. TDCheckPath=
  410.   Full DRIVE:\PATH\FILENAME of TDCHECK.EXE. (or "NONE" if not using)
  411.   SAMPLE:  TDCheckPath=C:\UTILITY\TDCHECK.EXE
  412.  
  413. TcanPath=
  414.   The full DRIVE\PATH\FILENAME of your ZLAB000.TCN (trashcan) file.  The 
  415.   filename need not follow the ZLABxxx.ext format, but it will make 
  416.   conference specific work much easier later.
  417.   SAMPLE:  TcanPath=C:\ZIPLAB\ZLAB000.TCN
  418.  
  419. UnZipPath=
  420.   Full DRIVE:\PATH\FILENAME of PKUNZIP.EXE.
  421.   SAMPLE:  UnZipPath=C:\UTILITY\PKUNZIP.EXE
  422.  
  423.                                                                            Pg6
  424.  
  425. ZDCSPath=
  426.   Full DRIVE:\PATH\FILENAME of ZDCSFC.EXE, main executable for the
  427.   ZDCS duplicate checking system.  Use NONE if you wish to disable
  428.   this feature.
  429.   SAMPLE:  ZDCSPath=C:\ZDCS\ZDCSFC.EXE 
  430.  
  431. ZShellPath=
  432.   Full DRIVE:\PATH\FILENAME of ZSHELL.EXE  This executable is run by 
  433.   ZipLab, and should not be run from the DOS command line.  It is
  434.   required that ZipLab know where to find the file.
  435.   SAMPLE: ZShellPath=C:\ZIPLAB\ZSHELL.EXE
  436.  
  437. ZipPath=
  438.   Full DRIVE:\PATH\FILENAME of PKZIP.EXE.
  439.   SAMPLE:  ZipPath=C:\UTILITY\PKZIP.EXE
  440.  
  441. GiftestParms=
  442.   Command line PARAMETERS you wish to pass to GIFTEST.EXE Please refer to 
  443.   the documentation for GIFTEST for details! Just enter "NONE" if you do not 
  444.   desire to pass parameters.
  445.   SAMPLE:  GiftestParms=NONE
  446.  
  447. ScanErrorLevel=
  448.   The DOS ERRORLEVEL which is set by your virus checker if a file virus is 
  449.   detected.  This can only be ONE number, and unlike DOS, it is not a 
  450.   function of "more than this number".  It is EXACTLY this number.  Again, I 
  451.   have tested this with SCAN and F-PROT, but have no idea if any other virus 
  452.   checkers return appropriate ERRORLEVELs.  The ERRORLEVELS set on virus 
  453.   detection for the two programs that I have tested are:
  454.   
  455.   SCAN         1
  456.   F-PROT       3
  457.   SAMPLE:  ScanErrorLevel=1
  458.  
  459. ScanParms=
  460.   Optional command line switches to pass to the virus checker.  Be sure you 
  461.   have read the docs for the program you use.  As with the program in 
  462.   general, I only warrent that the switches I have used as an example for 
  463.   SCAN or F-PROT will work correctly.  If you decide to use something else, 
  464.   be sure you understand and have tested any switches you provide.  I do 
  465.   feel confident that these work:
  466.   
  467.   SCAN         /NOMEM /NOBREAK /NOEXPIRE /NOPAUS
  468.   F-PROT       /NOMEM /NOBREAK /OLD
  469.   
  470.   Do NOT set a switch which causes the virus checking program to delete or 
  471.   rename the file.  ZipLab will take care of that.
  472.   
  473.   "NONE" will cause ZipLab to not pass any parameters except the filename(s) 
  474.   to test.
  475.   SAMPLE:  ScanParms=/NOMEM /NOBREAK /NOEXPIRE /NOPAUSE
  476.  
  477.                                                                            Pg7
  478.  
  479. UnZipParms=
  480.   An optional list of extra parameters you wish to pass to PKUNZIP.EXE on 
  481.   the command line.  If using PKUNZIP 2.0, use the command line parameter 
  482.   additions as suggested in the example ZLAB000.CFG that follows.  Some 
  483.   PKUNZIP 2.0 switches:
  484.   
  485.   -)     Turn off DMPI memory usage
  486.   --     Turn off XMS memory usage
  487.   -+     Turn off EMS memory usage
  488.   -3     Turn off 386cpu specific code
  489.   
  490.   "NONE" will cause ZipLab not to pass any extra parameters. If you are 
  491.   using PKZip 1.1, NONE is appropriate.
  492.   SAMPLE: UnZipParms=NONE
  493.  
  494. ZipParms=
  495.   An optional list of extra parameters you wish to pass to PKZIP.EXE on the 
  496.   command line.  If you are using PKZIP 2.0, use the command line parameter 
  497.   additions as suggested in the example ZLAB000.CFG that follows.  Some 
  498.   PKZIP 2.0 switches:
  499.   
  500.   -)     Turn off DMPI memory usage
  501.   --     Turn off XMS memory usage
  502.   -+     Turn off EMS memory usage
  503.   -3     Turn off 386cpu specific code
  504.   -~     Turn off NETWORK specific code
  505.   -(     Uses slower form of memory handling
  506.   
  507.   "NONE" will cause ZipLab not to pass any extra parameters. If you are 
  508.    using PKZip 1.1, NONE is appropriate.
  509.   SAMPLE: ZipParms=NONE
  510.      
  511.  
  512. * Save the ZLAB000.CFG file with your changes, and then run the program 
  513.   ZVALID.EXE - "ZVALID ZLAB000.CFG".  A text file called ZVALID.RPT will be 
  514.   created in your current directory, with notations anyplace that there are 
  515.   errors or missing items in your .CFG file.  Re-edit your ZLAB000.CFG and 
  516.   re-run "ZVALID ZLAB000.CFG" until you have a solid column of "OK!" at
  517.   the right of the ZVALID.RPT file.  You can then be sure that your .CFG
  518.   file is correct for your sytem.
  519.  
  520. * Edit your existing PCBTEST.BAT file, and delete the whole thing except 
  521.   for two lines:
  522.   
  523.   Sample PCBTEST.BAT file:
  524.   
  525.   @ECHO OFF
  526.   C:\ZIPLAB\ZLAB.EXE %1 C:\PCB C:\ZIPLAB %2
  527.                      ^1 ^2     ^3        ^4
  528.   
  529.   1)  %1         PCBoard will populate this with the DRIVE\PATH\FILE to test.
  530.   2)  C:\PCB     The PCBoard "home" directory for the node.
  531.   3)  C:\ZIPLAB  The directory containing your ZLABxxx.CFG file(s).
  532.   4)  %2         PCBoard will populate this with TEST if a user is running
  533.                  the TEST command on the board.  You can also pass LOCAL 
  534.                  to this parameter to run ZipLab from DOS.
  535.  
  536. * Note!  Although ZipLab can share its configuration files, it should be run 
  537.   FROM the PCBoard "home" directory of each node.  Do not change directories 
  538.   in PCBTEST.BAT to your "ZIPLAB" directory.
  539.  
  540.                                                                            Pg8
  541.  
  542. ##############################################################################
  543.                        A SAMPLE ZLAB000.CFG FILE
  544. ##############################################################################
  545.  
  546. [Preferences]
  547. BBSName=The Interconnect Bulletin Board System
  548. DateInDesc=Y
  549. DateLimit=199101
  550. DizInComment=Y
  551. DizInDesc=Y
  552. FilesInDesc=Y
  553. Handshake=2
  554. OKExtensions=GIF;TXT;JPG
  555. SendMsgToMain=Y
  556. SendSysopMsg=Y
  557. SendUserMsg=Y
  558.  
  559. [Locations]
  560. ARJPath=C:\UTILITY\ARJ.EXE
  561. AddFilePath=NONE
  562. CRCPath=C:\ZIPLAB\CRC.ADS
  563. CommentPath=C:\ZIPLAB\ZLAB000.CMT
  564. DelfPath=C:\UTILITY\DELF.COM
  565. FailDir=C:\FAIL
  566. GiftestPath=C:\UTILITY\GIFTEST.EXE
  567. LHAPath=C:\UTILITY\LHA.EXE
  568. LSTPath=C:\ZIPLAB\LST.ADS
  569. MsgDir=C:\ZIPLAB
  570. RecomPath=C:\UTILITY\RECOM.EXE
  571. ScanPath=C:\UTILITY\SCAN.EXE
  572. TDCheckPath=C:\UTILITY\TDCHECK.EXE
  573. TcanPath=C:\ZIPLAB\ZLAB000.TCN
  574. UnZipPath=C:\UTILITY\PKUNZIP.EXE
  575. ZDCSPath=C:\ZDCS\ZDCSFC.EXE
  576. ZShellPath=C:\UTILITY\ZSHELL.EXE
  577. ZipPath=C:\UTILITY\PKZIP.EXE
  578.  
  579. [Parmameters]
  580. GiftestParms=NONE
  581. ScanErrorLevel=1
  582. ScanParms=/NOMEM /NOBREAK /NOEXPIRE /NOPAUSE
  583. UnZipParms=NONE
  584. ZipParms=NONE
  585.  
  586.  
  587.                                                                            Pg9
  588.  
  589. ##############################################################################
  590.                            CONFIGURATION DETAILS       
  591. ##############################################################################
  592.  
  593. I.    Conference Specific Configurations
  594.  
  595. You MUST at least have created a file named ZLAB000.CFG for ZipLab Plus to 
  596. operate.  The "000" tells ZipLab that this is the configuration file for the 
  597. Main Board Conference, but is also the default for any conferences that do 
  598. not have specific configuration files. 
  599.  
  600. To create a configuration for another conference (let's use your "GAMES" 
  601. conference, number "5", as an example), copy ZLAB000.CFG to another file, 
  602. replacing the "000" with the conference you wish to set up.  In this case, 
  603. you would copy ZLAB000.CFG to ZLAB005.CFG.  Then, modify ZLAB005.CFG to be 
  604. specific to your Games Conference.
  605.  
  606. You can change just about every configuration item to be specific to the 
  607. Games conference.  Some things you might want to change are:
  608.  
  609. * The "Board Name" field - Maybe It will say "Joes BBS - Games Conference"
  610. * The name of your .TCN (trashcan) file.  You may want to exclude more
  611.   (or less) types of files from this conference.  Just call the file
  612.   ZLAB005.TCN.
  613. * The "Date Limit" field.  Maybe you want only the LATEST games.
  614. * The "Zip Comment" field.  Have a conference specific .ZIP comment by
  615.   changing the name to ZLAB005.CMT.
  616. * The use (or non-use) of GIFTEST.EXE, and the acceptance of .GIF files.  
  617.  
  618.  
  619. Repeat this process for any other conferences you wish to have specific 
  620. ZipLab configurations for.  Don't forget, as ZipLab will use ZLAB000.CFG for 
  621. any conference for which there is not a specific .CFG file, you don't HAVE 
  622. to set up config files for any conference except the Main Board.
  623.  
  624. * Note!  Be sure that any files like ZLAB005.TCN or ZLAB005.CMT that you 
  625.   specify actually do exist!  You can create them before or after you edit 
  626.   the config files, but certainly before you run ZipLab Plus (unless you 
  627.   want to test my error handling system <g>).   
  628.  
  629.  
  630. II.   The ZDCS Duplicate Checking System
  631.  
  632. ZDCS is a set of programs written and distributed as Shareware by Mike W. 
  633. Cocke.  This program will create a database of all files (including all 
  634. files INSIDE archives) on your BBS.  When run against an upload, ZDCS will 
  635. check its database against the individual members of the uploaded archive, 
  636. and can be given a percentage of duplicate files which will be allowed. If 
  637. the percentage of files in this archive which are already in other archives 
  638. on your system exceeds the allowed percentage, ZDCS will tell ZipLab to 
  639. "fail" the file.
  640.  
  641. When configuring ZDCS for ZipLab, do not have ZDCS erase or move any files 
  642. which "fail" testing.  ZipLab will handle that part of it.
  643.  
  644. You must have version 2.01 or better of ZDCS for the integration between 
  645. ZipLab and ZDCS to appear "seamless", but version 2.0 of ZDCS will function 
  646. correctly otherwise.
  647.  
  648.                                                                            Pg10
  649.  
  650. The latest version of ZDCS is available on The Hacker's Central BBS, at 
  651. (201)-335-9343.  Mike has stated that he will allow download of ZDCS by 
  652. first-time callers to his BBS.
  653.  
  654. NOTE!  ZDCS is a Shareware program, and your registration of ZipLab does
  655.        NOT entitle you to use ZDCS for longer than a normal 30-day 
  656.        evaluation period.  Please register ZDCS if you plan to use it
  657.        with or without ZipLab.
  658.  
  659. I DO NOT provide technical support for ZDCS.  I found the documentation 
  660. provided with the package to be clear and correct, and further support for 
  661. registered ZDCS users can be arranged with the author of ZDCS.  I will say 
  662. it now, so there is no mistake... I run ZDCS 2.01 with ZipLab here, it works 
  663. GREAT, and if it doesn't work right for you, you need to review all 
  664. documentation.  I will not answer questions in any forum concerning the care 
  665. and feeding of ZDCS.  For that matter, I don't expect the author of ZDCS to 
  666. answer questions about problems you may have with ZipLab.
  667.  
  668.  
  669. III.  ZLABxxx.TCN  The "trashcan" file(s)
  670.  
  671. This file holds text key-words or key-phrases which are used to reject files 
  672. based on either the filename or contents of the file description. If you for 
  673. instance did not want "adult" .GIF files uploaded to your system, but did 
  674. want to allow other .GIF file uploads, you might put the following lines in 
  675. ZLAB000.TCN:
  676.  
  677. ADULT
  678. X-RATED  
  679. "X RATED"
  680. MARGARINE
  681. "KITCHEN TABLE"
  682.  
  683. Or whatever you feel would allow ZipLab to identify the kind of files you 
  684. have in mind, without being so generic as to cause perfectly acceptable 
  685. files to fail.
  686.  
  687. ZipLab Plus will test the filename, user supplied description, and the 
  688. contents of FILE_ID.DIZ (if found) against this list, and will reject any 
  689. files which contain these "trashcan" words/phrases.
  690.  
  691. * Note!  To imbedd "white space" either in, before, or after an entry, use 
  692.   the QUOTE (") character to surround the phrase or word. For instance, if 
  693.   you wanted to exclude files with the word "WIN" in them, you should use
  694.   " WIN " so that things like "TWIN" or "WINNER" don't also fail.
  695.  
  696.   
  697. IV.   ZLAB000.CMT  The "comment" file(s)
  698.  
  699. This is a text file which will be added as a .ZIP (or .ARJ) comment to the 
  700. archive file.  As you can see from the filename format, you can certainly 
  701. have a different comment file for each conference if you so desire.
  702.  
  703.                                                                            Pg11
  704.  
  705. This file can say anything you want.  I have also included some ZIPLAB- 
  706. specific "@ZCODES" which can be imbedded in the text to add information 
  707. which ZipLab Plus will provide at run-time.  You may NOT use PCBoard's 
  708. "@-Codes", only the ones that ZipLab Plus supplies:
  709.  
  710. @ZCODE      MEANING              FORMAT / ADDITIONAL DESCRIPTION
  711.  
  712. @ZFILENAME@     File Name            "filename.ext"                           
  713. @ZTYPE@         Archive Type         ".ZIP", ".ARJ", or ".LZH"                
  714. @ZUPLDATE@      Date Tested          "mm/dd/yyyy"                             
  715. @ZUPLTIME@      Time Tested          "hh:mm:ss"                               
  716. @ZBBSNAME@      Board Name           from ZLABxxx.CFG                         
  717. @ZUSERNAME@     User Name            "firstname lastname"                     
  718. @ZUSERFNAME@    User First Name      "Sally", "John", etc..
  719. @ZNUMMEMBERS@   Number of Files      count of files in archive                   
  720. @ZNEWEST@       Newest File          "mm/dd/yyyy"                           
  721. @ZOLDEST@       Oldest File          "mm/dd/yyyy"                              
  722. @ZPASSFAIL@     Pass-Fail Status     "passed" or "failed"                      
  723. @ZFAILREASON@   Reason for Failure   "CRC checking" , "Virus checking" etc...  
  724. @ZTCANTEXT@     Trash Can Text       Text which failed .TCN checking - if any. 
  725. @ZVERSION@      Version Number       Version of ZipLab Plus ("2.0")            
  726. @ZDATELIMIT@    Date Limit           "mm/dd/yyyy"                              
  727. @ZFOUNDDIZ@     FILE_ID.DIZ Found    "found" or "not found"                    
  728. @ZNODE@         Node Number          BBS node number                           
  729. @ZCONFERENCE@   Conference Number    conference the user is in (as a number)   
  730.  
  731. * Note!  You may also use the word "ZIPLAB" in this field in ZLABxxx.CFG, 
  732.   and ZipLab will create a comment for you, with much of the above 
  733.   information. As always, you may also use "NONE", and ZipLab will not add 
  734.   any comment at all.
  735.  
  736.  
  737. V.    CRC.ADS
  738.  
  739. This file will contain the file CRC-32 values (and names) of files which
  740. you wish removed from the archive prior to posting.  The format of the
  741. file is:
  742.  
  743. 00000000,filename.ext
  744.  
  745. Where "00000000" is the file's CRC-32, and filename.ext is one of the names 
  746. by which the file is known.  The filename is not optional, but can really be 
  747. anything, as ZipLab could care less what a file is called. If it matches on 
  748. the CRC-32 value, it WILL be removed.
  749.  
  750. You will want to maintain your CRC.ADS file using the ZCRC.EXE file which is 
  751. included in the ZipLab Plus archive.  Just type:
  752.  
  753. "ZCRC [d:\path\]CRC.ADS [d:\path\]filename.ext" 
  754.  
  755. and ZCRC.EXE will place the proper information for the filename you replace 
  756. "filename.ext" with at the bottom of the CRC.ADS file.
  757.  
  758. As always, a "NONE" in the ZLABxxx.CFG file in this position will cause 
  759. ZipLab Plus to skip this process.
  760.  
  761. * Note!  It is certainly acceptable to have different "CRC.ADS" files for 
  762. different confereneces, and you could use the "ZLABxxx.CRC" convention if 
  763. you wish.  I find that trying to maintain multiple versions of this file to 
  764. be a fair amount of trouble however, and don't particuarly recommend it.
  765.  
  766.                                                                            Pg12
  767.  
  768. VI.   LST.ADS
  769.  
  770. This is a text file (one on each line) containing only the names of files 
  771. you wish removed without testing.  The difference between this file and the 
  772. CRC.ADS file is that you can test for a particular file name, and it will 
  773. remove it even if the person adding the file changes the contents from time 
  774. to time.  This file also supports "wildcards", so you can test for those 
  775. names where "special" characters (above 126 ASCII) have been used to create 
  776. a filename, by masking out those characters.
  777.  
  778. As an example, you could test for a BBS ad called "S£ïMΣ.Pïτ" by adding 
  779. "S??M?.P??" as an entry in LST.ADS (of course, "SIMMS.PAS" would fail as 
  780. well, so be careful how you use wildcards.).
  781.  
  782. Use "NONE" in the field in ZLABxxx.CFG to disable this feature.
  783.  
  784.  
  785. VII.  *.MSG  The mail message files
  786.  
  787. The mail message files are text files (the @ZCodes can be used, and in fact 
  788. you could imbedd PCBoard's @Codes as well, they will just get passed through 
  789. to the message and handled by PCBoard when the user reads the message.), 
  790. which will constitute mail messages sent to the user when a file fails. This 
  791. can be used to tell the user the reason for the rejection, to remind him of 
  792. rules you may have about types of file you accept, or to reassure him that 
  793. you still love him even though his file did have a CRC error <g>.
  794.  
  795. Remember when modifying or creating these files, that there are limits on 
  796. mail messages in PCBoard.  Also, be sure to leave enough room for any 
  797. @ZCodes to expand to actual values without running longer than 78 characters 
  798. per line.
  799.  
  800. The files MUST have the names below, and samples of all the files are 
  801. included in this archive.  These files should be in a central location, 
  802. perhaps the C:\ZIPLAB directory where you have the .TCN, .CMT and other 
  803. ZipLab files is best.  One of the entries in the ZLABxxx.CFG files will let 
  804. you tell ZipLab where to find these files.
  805.  
  806. The files (and failure reasons) that ZipLab Plus uses are:
  807.  
  808. NAME OF FILE      REASON FOR FAILURE 
  809. ------------      ------------------
  810. OLDDATE.MSG       Failed date limit checking
  811. FILECRC.MSG       Failed CRC or -AV checking
  812. DUPES.MSG         Failed ZDCS duplicate checking
  813. IMBEDCRC.MSG      An imbedded archive failed CRC or -AV checking
  814. TRASHCAN.MSG      .TCN (Trashcan) text was found in the description
  815. BADTD0.MSG        A Teledisk format (.TD0) file failed TDCHECK
  816. USRVIRUS.MSG      Message sent to USER on virus detection
  817. SYSVIRUS.MSG      Message sent to SYSOP on virus detection
  818. UNACCEPT.MSG      An unaccepted file format was uploaded
  819. GIFFAIL.MSG       A .GIF file failed GIFTEST
  820.  
  821. DO NOT RENAME THESE FILES!
  822.  
  823.  
  824.                                                                            Pg13
  825.  
  826. VIII. PKZIP 2.04
  827.  
  828. There have been found to be problems with PKZIP 2.04 and some hardware.  If 
  829. you have problems with PKZIP 2.04 and ZipLab, you should use the command 
  830. line parameters in the example .CFG file in this documentation (Page 7).  
  831. These command line parameters will disable certain "advanced" memory 
  832. functions of PKZIP and PKUNZIP.  The command line parameters are explained 
  833. in the detailed section about the ZLABxxx.CFG file (Pages 4 and 5).   
  834.  
  835. NOTE!  There are two switches "-~" and "-)" shown for PKZIP.EXE and not for 
  836. PKUNZIP.EXE.  PKUNZIP.EXE does not support (or require) these switches, and 
  837. their use will cause an error.
  838.  
  839. NOTE!  DO NOT PASS THE ACTUAL COMMAND FUNCTION (like -a or -d for PKZIP / -x 
  840. or -v for PKUNZIP) on this line of extra parameters.  ZipLab will pass the 
  841. appropriate primary command parameter.  You should only send extra switches 
  842. which change the operation of PKZIP or PKUNZIP.  READ THE DOCS FROM PKWARE
  843. BEFORE USING OPTIONS OTHER THAN THOSE IN THE SAMPLE!  READ BOTH MANUAL.DOC
  844. AND ADDENDUM.DOC WHICH CAME IN PKZ204C.EXE.  IF IN DOUBT, DON'T DO IT!
  845.  
  846.  
  847.                                                                            Pg14
  848.  
  849. ##############################################################################
  850.                          USAGE NOTES AND WARNINGS
  851. ##############################################################################
  852.  
  853. I.   Command line parameters -
  854.  
  855. ZLAB.EXE has the following commmand syntax:
  856.  
  857. ZLAB d:\path\filename d:\pcbpath d:\cfgpath [UPLOAD|LOCAL|TEST]
  858.  
  859. d:\path\filename - The file to test, normally passed by PCBoard.
  860. d:\pcbpath       - The "home" PCBoard directory for this node.
  861. d:\cfgpath       - The directory containing your ZLABxxx.CFG files.
  862. UPLOAD           - This is the default if no 4th parameter is given.
  863.                    ZipLab will consider itself to be in regular "online"
  864.                    upload mode.  PCBoard will pass this in %2 when a 
  865.                    user uploads to the board.
  866. LOCAL            - Causes ZipLab to function without any output to the 
  867.                    comm port.  Use this for testing files already on your 
  868.                    hard drive, or that you have downloaded yourself and 
  869.                    wish to post.  No changes will be made to any DIRx 
  870.                    files.  Failed files will be moved to your "fail" dir.
  871. TEST             - PCBoard will pass this as %2 if you are using the TEST 
  872.                    command inside PCBoard.  Files will only be moved to 
  873.                    the "hold" directory if they fail CRC or Virus 
  874.                    checking.  No changes will be made to any DIRx files.  
  875.                    Normal comm port output.                   
  876.  
  877.  
  878. II.  PCBoard's "TEMP" directory -
  879.  
  880. Line 179 of your PCBOARD.DAT file (maintained with PCBSETUP.EXE) is 
  881. critical to the operation of ZipLab Plus.  This is the "temporary" 
  882. directory in which (among other things) PCBoard holds the file 
  883. descriptions for uploads before they are actually posted.  This directory 
  884. MUST exist, and be EMPTY (don't use your root directory of your boot drive 
  885. like a couple of people have in the past!).  PCBSETUP WILL NOT CREATE THIS 
  886. DIRECTORY WHEN YOU EXIT, even though it does create just about every other 
  887. directory you specify if it doesn't exist.  This is just a quirk of 
  888. PCBSETUP, and it is up to you to be SURE this directory is both in 
  889. PCBOARD.DAT and that it exists.
  890.  
  891.  
  892.                                                                            Pg15
  893.   
  894. III. ZipLab Plus' "WORK" directory -
  895.  
  896. This directory is created (and removed) each time ZipLab Plus runs.  It
  897. is used to hold unzipped files and other temporary files while ZipLab is
  898. running.  By default, ZipLab creates a new directory under your current
  899. one (your PCBoard root directory in most cases) called .\ZLAB.DIR, which
  900. it removes when done.  If you want to redirect this to another drive
  901. (say a RAM drive for additional speed), set an environment variable 
  902. called "ZIPLAB" to the drive and directory name you wish.
  903.  
  904. SET ZIPLAB=E:\ZWORK
  905.  
  906. * Note!  This is another case where flexiblity is great, but can be 
  907.   dangerous if you don't pay attention.  Setting ZIPLAB= to oh, say the 
  908.   root directory of your boot drive - would have results which may cause 
  909.   you to think poorly of my program (and I of your mental capacity).
  910.  
  911.  
  912. IV.  Using GIFTEST with ZipLab
  913.  
  914. ZipLab does not pass any default parameters at all to Giftest.Exe.  You 
  915. will need to do that by specifing the parameters on the line in the
  916. ZLAB000.CFG which is for this purpose.  If all you want to do is test .GIF 
  917. files for integrity, and make sure they pass some standard of resolution 
  918. and colors that you set, This is all pretty easy.  Just use:
  919.      
  920. /M:640X480X256     (replace the resolution and colors with yours)
  921.      
  922. Giftest will work just fine with a simple parameter line like this. If you 
  923. want to insert the resolution/colors into the PCBoard description, it gets 
  924. a bit tricky... The first thing you have to tell Giftest is what board 
  925. type you are running, so follow the parms above (no spaces) with:
  926.  
  927. /B:x   (Where "x" is a "1" for ProDoor or a "2" for PCBoard)
  928.  
  929. Now we need to tell Giftest where the description file is for the node you 
  930. are on.  This is the tricky part... To do this, you are GOING TO HAVE TO 
  931. HAVE A DIFFERENT ZLAB000.CFG FILE FOR EACH NODE. Follow the parms above 
  932. (no spaces) with:
  933.  
  934. /F:drive:\path\description.file 
  935.  
  936. Now in PCBoard, that is going to be the drive and directory which is 
  937. specified on line 179 of PCBoard.Dat, and then the filename of UPDESC.x 
  938. where "x" is replaced with the node number for the current node.  (just 
  939. use UPDESC without an extension if you are not running nodes)
  940.  
  941. In Prodoor, the path will be your PCB home directory FOR THAT NODE, and 
  942. the filename will be $DOOR.NAM.
  943.  
  944. Please do not use the "/E" parameter on the Giftest parameter line. ZipLab 
  945. will take care of the file if it fails, there is no need to have Giftest 
  946. erase the file, and it will only confuse ZipLab.
  947.                                                   
  948. You will then have to do this for each node you have, and they will have
  949. to be in different directories.  I recommend that you use something like
  950. C:\ZIPLAB\NODE1 as a directory to hold your node 1 .CFG files.  All the
  951. other files for ZipLab with the exception of the ZLABxxx.CFG files can
  952. still be shared and can reside in C:\ZIPLAB or wherever you have specified
  953. in the .CFG files.
  954.  
  955.                                                                           Pg16
  956. Then change your ZLAB command line in PCBTEST.BAT to something this for
  957. node 1:
  958.  
  959. PCBoard:
  960. ZLAB %1 %PCBDRIVE%%PCBDIR% C:\ZIPLAB\NODE1 %2
  961.  
  962. ProDoor:
  963. ZLAB %TARGET% %pcbdrive%%pcbdir% C:\ZIPLAB\NODE1
  964.  
  965. The other option is to put the ZLABxxx.CFG files in the home PCB directory
  966. for each node, and then the command line is simple:
  967.  
  968. PCBoard:
  969. ZLAB %1 %PCBDRIVE%%PCBDIR% %PCBDRIVE%%PCBDIR% %2
  970.  
  971. ProDoor:
  972. ZLAB %TARGET% %pcbdrive%%pcbdir% %pcbdrive%%pcbdir% 
  973.      
  974.  
  975.                                                                           Pg17
  976.  
  977. ##############################################################################
  978.                         SOME NOTES ON MEMORY USAGE
  979. ##############################################################################
  980.  
  981. * NOTE!  Since PCBoard is SHELLING out to run PCBTEST.BAT, there is 
  982.   limited memory available for ZLAB.EXE.  If you are running in a 
  983.   multitasking or other memory constrained situation, ZLAB may not work! 
  984.   You should have at least 250k free memory when shelled out of PCBoard.  
  985.   If this is a problem, you may want to consider the VAROOM (overlay) 
  986.   version of PCBoard, which runs in considerably less memory than the 
  987.   standard PCB.EXE.
  988.   
  989.   The other option is to run PCBoard with the SET PCB = /SWAP environment 
  990.   variable.  This will cause PCBoard to "swap" its code to the best 
  991.   available storage (EMS, DISK) whenever a SHELL function (external 
  992.   protocol, viewfile, and even DOORS if you have the SHELL column in 
  993.   DOORS.DAT(LST) set to "Y") is called.  This method will cause a slight 
  994.   delay when SHELLING, but will provide the largest amount of available 
  995.   DOS memory for your external code.
  996.  
  997.   It has been brought to my attention that a program called SHROOM may
  998.   provide the maximum in memory when ZipLab is running.  I have not 
  999.   tested SHROOM (Shell Room) with ZipLab, and can't guarantee that it
  1000.   will work in all cases.
  1001.  
  1002.                                                                           Pg18
  1003.  
  1004. ##############################################################################
  1005.                            PRODOOR DIFFERENCES         
  1006. ##############################################################################
  1007.  
  1008. *  PRODOOR SYSOPS -
  1009.    You will need to set up your PROUTEST.BAT file like this:
  1010.                 
  1011.    
  1012.    @echo off
  1013.    rem -- process test uploads request - for ProDOOR 3.44
  1014.    rem -- %1-logfile, %2-testdir, %3-comport
  1015.    
  1016.    rem -- test each uploaded file individually
  1017.    proecho %3 ~~Testing uploads.  Please wait...~
  1018.    
  1019.    SET PCBDOOR=PRODOOR
  1020.    for %f in (%2\*.*) do COMMAND /c ZLAB %f d:\pcbpath d:\path\cfgpath 
  1021.    SET PCBDOOR=
  1022.    
  1023.    :end
  1024.  
  1025.    Be sure you have enough ENVIRONMENT space to set up the PCBDOOR variable.  
  1026.    If you are using DesqView, you may want to set PCBDOOR=xxxxxxx in your 
  1027.    AUTOEXEC.BAT to be sure enough room is allocated in your DesqView 
  1028.    partitions for this variable.  The x's will be replaced by PRODOOR when 
  1029.    PROUTEST.BAT is executed.  I need this variable set to "PRODOOR", or ZLAB 
  1030.    won't know you are running out of ProDoor.  You don't want to leave it set 
  1031.    to PRODOOR though, since this could confuse things for other 
  1032.    doors/processes. Thus the "SET PCBDOOR=" line.  ZipLab will fully work with 
  1033.    ProDoor, including display/modification of the file descriptions.
  1034.    
  1035.              
  1036. * Note!   Sam Smith has included an example PROUTEST.BAT/PROUT1.BAT 
  1037.           with ProDoor, which as of this writing shows how to use 
  1038.           ZipLab Plus 1.9c to do testing.  This WILL NOT work with 
  1039.           ZipLab Plus 2.0, as the command line parameters for ZipLab 
  1040.           have changed.
  1041.           
  1042.           Here is the relevant portion of PROUT1.BAT (called by
  1043.           PROUTEST.BAT).
  1044.           
  1045.   rem -- test archives using ziplab plus by jeffrey s. morley
  1046.   rem -- ziplab plus tests zip, arj, and lzh files
  1047.   :test
  1048.   addbidir %pcbdrive%%pcbdir%\$door.nam %TARGET%
  1049.  
  1050.   tm /l ptest %TARGET% u:\prod\ptest%PCBNODE%.cfg >>u:\prod\test%PCBNODE%.log
  1051.   set PCBDOOR=PRODOOR
  1052.   set ZIPLAB=T:\PTEST%PCBNODE%
  1053.   cdto t:\scr%PCBNODE%
  1054. ! ptest %TARGET% u:\prod\ptest%PCBNODE%.cfg
  1055.   cdto u:\prod
  1056.   set PCBDOOR=
  1057.   if not exist %TARGET% del %dszlog%
  1058.   if not exist %TARGET% goto end
  1059.  
  1060.   :end
  1061.  
  1062.  
  1063.                                                                           Pg19
  1064.  
  1065.           The line I have marked with an "!" is the command line for
  1066.           ZLAB.EXE and MUST be changed to read:
  1067.           
  1068.           zlab %TARGET% %pcbdrive%%pcbdir% u:\prod
  1069.           
  1070.           if you are going to use the sample PROUTEST/PROUT1 batch
  1071.           files from Sam.
  1072.           
  1073.        
  1074.                
  1075.                                                                           Pg20
  1076.  
  1077. ##############################################################################
  1078.                      VERSION HISTORY (NEWEST TO OLDEST)
  1079. ##############################################################################
  1080.  
  1081.                          ZipLab Plus Beta 2.ß.1
  1082.                         Version 2.0 beta version
  1083.                            December 27, 1992
  1084.                            
  1085. First release of version 2.0 to wide-area beta.  Please, Please! read the
  1086. documentation carefully, as well as the BETA.DOC file included.  Significant
  1087. changes have been made to every part of ZipLab Plus, and none of your old
  1088. executables or configurations will work without replacement or modification.
  1089.                            
  1090.  
  1091.  
  1092.                                                                           Pg21
  1093.  
  1094. ##############################################################################
  1095.                       ABOUT ZIPLAB PLUS AND THE AUTHOR
  1096. ##############################################################################
  1097.    
  1098. ZipLab Plus started out as a somewhat complicated batch file sometime in 
  1099. 1989.  We all had been running PKUNZIP -t against uploads for some time, but 
  1100. I wanted a batch file that would do a bit more, like use SCAN to test for 
  1101. virus infection, reject old archives, and strip out .ZIP comments.  I also 
  1102. wanted to present an interesting interface to the user, letting him/her 
  1103. know what was going on in the program.
  1104.  
  1105. As the functions in ZipLab increased and became more complicated, it took 
  1106. longer and longer to test files in the somewhat inefficient batch file 
  1107. environment.  I then decided to port the program over to my programming
  1108. language of choice (or at least default) QuickBasic 4.5.           
  1109.  
  1110. At this time I decided to make the program "shareware" to compensate for
  1111. at least some of the time I was spending on the program.  I must say that
  1112. ZipLab Plus has exceeded my expectations as a shareware offering, and I
  1113. am grateful (and a little stunned) for the response by Sysops who have
  1114. registered the program.  I had always heard figures like "only 5% or less
  1115. of those who use shareware register", but if this is true then 10's of 
  1116. thousands of sysops are currently using ZipLab Plus.  I don't believe that
  1117. to be the case, and am instead inclined to believe that sysops, unlike
  1118. doctors and lawyers, are NOT their own worst customers.
  1119.  
  1120. This program was written in QuickBasic 4.5, with some help from Hammerly 
  1121. Computing's ProBas 4.01 and various home-grown assembly and C routines.  I 
  1122. have included a few utilities which ZLAB will use in the course of testing.  
  1123. These utilities are the property of the authors, and you are strongly 
  1124. requested to register them if you continue to use ZIPLAB PLUS.
  1125.  
  1126.                              Jeffrey S. Morley
  1127.                            The Interconnect BBS
  1128.                                (703)425-2505
  1129.  
  1130.             PLEASE SEE REGISTER.DOC FOR REGISTRATION INFORMATION
  1131.  
  1132.                 (C)Copyright 1989-1993 by Jeffrey S. Morley
  1133.  
  1134.  
  1135.